Configuring Media Realms

The Media Realms table lets you configure a pool of up to 1,024 SIP media interfaces, termed Media Realms. Media Realms lets you divide a Media-type interface (configured in the IP Interfaces table) into several media realms, where each realm is specified by a UDP port range. Media Realms also define the maximum number of permitted media sessions.

Once configured, to apply Media Realms to specific calls, you need to assign them to any of the following configuration entities:

IP Groups (see Configuring IP Groups)
SIP Interfaces (see Configuring SIP Interfaces)

You can also apply the device's Quality of Experience feature to Media Realms:

Quality of Experience Profile: Call quality monitoring based on thresholds for voice metrics (e.g., MOS) can be applied per Media Realm. For example, if MOS is considered poor, calls on this Media Realm can be rejected. To configure Quality of Experience Profiles, see Configuring Quality of Experience Profiles.
Bandwidth Profile: Bandwidth utilization thresholds can be applied per Media Realm. For example, if bandwidth thresholds are crossed, the device can reject any new new calls on this Media Realm. To configure Bandwidth Profiles, see Configuring Bandwidth Profiles.

The Media Realms table provides the following "child" tables:

Remote Media Subnets: Defines remote destination subnets per Media Realm and assigns each subnet a Quality of Experience Profile and Bandwidth Profile. For more information, see Configuring Remote Media Subnets.
Media Realm Extensions: Defines port ranges for multiple Media-type interfaces per Media Realm. For more information, see Configuring Media Realm Extensions.
The Media Realm assigned to an IP Group overrides any other Media Realm assigned to any other configuration entity associated with the call.
If you modify a Media Realm that is currently being used by a call, the device doesn't perform Quality of Experience for the call.
If you delete a Media Realm that is currently being used by a call, the device maintains the call until the call parties end the call.
The device provides a default Media Realm ("DefaultRealm"), which you can modify or delete.

The following procedure describes how to configure Media Realms through the Web interface. You can also configure it through ini file [CpMediaRealm] or CLI (configure voip > realm).

To configure a Media Realm:
1. Open the Media Realms table (Setup menu > Signaling & Media tab > Core Entities folder > Media Realms).
2. Click New; the following dialog box appears:

3. Configure the Media Realm according to the parameters described in the table below.
4. Click Apply.

Media Realms Table Parameter Descriptions

Parameter

Description

General

'Index'

[Index]

Defines an index number for the new table row.

Note: Each row must be configured with a unique index.

'Name'

name

[MediaRealmName]

Defines a descriptive name, which is used when associating the row in other tables.

The valid value is a string of up to 39 characters.

Note:

The parameter is mandatory.
Configure each row with a unique name.
The parameter value can't contain a forward slash (/).
The parameter value can't be configured with the character string "any" (upper or lower case).

'Topology Location'

topology-location

[TopologyLocation]

Defines the display location of the Media Realm in the Topology view.

[0] Down = (Default) The Media Realm element is displayed on the lower border of the view.
[1] Up = The Media Realm element is displayed on the upper border of the view.

For more information on the Topology view, see Building and Viewing SIP Entities in Topology View.

'IPv4 Interface Name'

ipv4

[IPv4IF]

Assigns an IPv4 interface to the Media Realm.

By default, no value is defined.

To configure IP network interfaces, see Configuring IP Network Interfaces.

'IPv6 Interface Name'

ipv6if

[IPv6IF]

Assigns an IPv6 interface to the Media Realm.

By default, no value is defined.

To configure IP network interfaces, see Configuring IP Network Interfaces.

'UDP Port Range Start'

port-range-start

[PortRangeStart]

Defines the starting port for the range of media interface UDP ports.

By default, no value is defined.

Note:

You must configure all your Media Realms with port ranges or all without; not some with and some without.
The available UDP port range is according to the [BaseUDPport] parameter. For more information, see Configuring RTP Base UDP Port.
The port number must be different from ports configured for SIP traffic (i.e., ports configured for SIP Interfaces) that use the same IP Interface. For example, if the RTP port range is 6000 to 6999, the SIP port can be less than 6000 or greater than 6999.
Media Realms associated with the same IP Interface must not have overlapping port ranges.
Media Realms and Media Realm Extensions associated with the same IP Interface must not have overlapping port ranges.

'Number of Media' Session Legs

session-leg

[MediaSessionLeg]

Defines the number of media sessions for the configured port range.

By default, no value is defined.

'UDP Port Range End'

port-range-end

[PortRangeEnd]

(Read-only field) Displays the ending port for the range of media interface UDP ports. The device automatically populates the parameter with a value, calculated by the summation of the 'UDP Port Range Start' parameter and 'Number of Media Session Legs' parameter (multiplied by the port chunk size) minus 1:

start port + (sessions * port spacing) - 1

For example, a port starting at 6,000, 5 sessions and 10 port spacing:

6,000 + (5 * 10) - 1 = 6,000 + (50) - 1 = 6,000 + 49 = 6,049

For more information on UDP port allocation and spacing, see Configuring RTP Base UDP Port.

'Default Media Realm'

is-default

[IsDefault]

Defines the Media Realm as the default Media Realm. The default Media Realm is used for SIP Interfaces and IP Groups for which you have not assigned a Media Realm.

[0] No (default)
[1] Yes

Note:

You can configure the parameter to Yes for only one Media Realm; all the other Media Realms must be configured to No.
If you do not configure the parameter (i.e., the parameter is No for all Media Realms), the device uses the first Media Realm in the table as the default.
If the table is not configured, the default Media Realm includes all configured media interfaces.

'Used By Routing Server'

used-by-routing-server

[UsedByRoutingServer]

Enables the Media Realm to be used by a third-party routing server or ARM for call routing decisions.

[0] Not Used (default)
[1] Used

For more information on the third-party routing server or ARM feature, see Centralized Third-Party Routing Server.

Quality of Experience

'QoE Profile'

qoe-profile

[QoeProfile]

Assigns a QoE Profile to the Media Realm.

By default, no value is defined.

To configure QoE Profiles, see Configuring Quality of Experience Profiles.

'BW Profile'

bw-profile

[BWProfile]

Assigns a Bandwidth Profile to the Media Realm.

By default, no value is defined.

To configure Bandwidth Profiles, see Configuring Bandwidth Profiles.